/*
* Copyright 2016 Yonyou Auto Information Technology（Shanghai） Co., Ltd. All Rights Reserved.
*
* This software is published under the terms of the YONYOU Software
* License version 1.0, a copy of which has been included with this
* distribution in the LICENSE.txt file.
*
* @Project Name : marketing-wechat-open-api
*
* @File name : AuthorityApiServiceInterface.java
*
* @Author : LiuJun
*
* @Date : 2016年11月28日
*
----------------------------------------------------------------------------------
*     Date       Who       Version     Comments
* 1. 2016年11月28日    LiuJun    1.0
*
*
*
*
----------------------------------------------------------------------------------
*/

package com.yonyou.gmcc.gateway.wechat.service.interfaces;

import org.springframework.cloud.netflix.feign.FeignClient;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;

/**
 *
 * @author LiuJun 授权入口API接口
 * @date 2016年11月28日
 */
@FeignClient(name = "service-wAuthorization")
public interface AuthorityApiServiceInterface {

	/**
	 *
	 * @author LiuJun 保存第三方平台授权ticket
	 * @date 2016年11月28日
	 * @param nonce
	 * @param timestamp
	 * @param encryptType
	 * @param msgSignature
	 * @param xml
	 * @throws Exception
	 */
	@RequestMapping(value = "/authorization/api/v1/tickets", method = RequestMethod.POST)
	public String saveTicket(@RequestParam("nonce") String nonce, @RequestParam("timestamp") String timestamp,
			@RequestParam("encrypt_type") String encryptType, @RequestParam("msg_signature") String msgSignature,
			@RequestBody String xml);

	/**
	 *
	 * @author LiuJun 生成授权登录URL-点击授权之后触发
	 * @date 2016年11月28日
	 * @param dealerId
	 * @return
	 * @throws Exception
	 */
	@RequestMapping(value = "/authorization/api/v1/loginURL/{dealerId}", method = RequestMethod.GET, produces = "text/plain;charset=UTF-8")
	public String getAuthorityURL(@PathVariable("dealerId") String dealerId);

	/**
	 *
	 * @author LiuJun 授权后-回调URL-其中参数授权码和过期日期 微信服务器在回调时会自动加上
	 * @date 2016年11月28日
	 * @param authCode
	 * @param expired
	 * @param dealerId
	 * @throws Exception
	 */
	@RequestMapping(value = "/authorization/api/v1/callback/{dealerCode}", method = RequestMethod.GET)
	public void receiveAuthorization(@RequestParam("auth_code") String authCode,
			@RequestParam("expires_in") Long expired, @PathVariable("dealerCode") String dealerCode);

	/**
	 *
	 * @author LiuJun 根据授权方appid获取token信息
	 * @date 2016年11月29日
	 * @param authorizerAppid
	 * @return
	 * @throws Exception
	 */
	@RequestMapping(value = "/authorization/api/v1/tokens/{authorizerAppid}", method = RequestMethod.GET, produces = "text/plain;charset=UTF-8")
	public String getAccessToken(@PathVariable("authorizerAppid") String authorizerAppid);

	/**
	 *
	 * @author LiuJun 刷新token
	 * @date 2016年12月19日
	 */
	@RequestMapping(value = "/authorization/api/v1/refreshTokens", method = RequestMethod.GET)
	public void refreshAccessToken();

	/**
	 *
	 * @author LiuJun 刷新ComponentAccessToken
	 * @date 2016年12月19日
	 * @throws Exception
	 */
	@RequestMapping(value = "/authorization/api/v1/refreshComponentAccessToken", method = RequestMethod.GET, produces = "text/plain;charset=UTF-8")
	public String refreshComponentAccessToken();

}
